@database ShutDown_help ShutDown v1.0 - (C) 1994 Tom De Voeght. Please use AmigaGuide or MultiView to read this document. @master ShutDown.guide @node main "ShutDown Doc" @{b}ShutDown v1.0 (C) 1994 Tom De Voeght.@{ub} _/ _/ _/_/_/_/ _/_/_/ _/_/_/ _/ _/ _/ _/ _/ A _/ _/ _/ _/_/_/ _/ _/ Production _/ _/ _/ _/ _/ _/ _/ _/ _/_/_/_/ _/_/_/ _/_/_/ This is the documentation of an advanced ShutDown command for the Amiga. @{" Introduction " link intro} @{" Execution & Startup " link execution} @{" Installation " link install} @{" About " link about} @{" Acknowledgements " link ack} @{" Author " link author} @{" History " link history} @{" To Do " link todo} @endnode @node intro "Introduction" Introduction : ~~~~~~~~~~~~~~ I once came across a command named 'reset' ; it looked good, and it was rather small, so I was really happy with it, but then ... As we all know resetting your Amiga can be dangerous, especially when there is/was any disk-activity at the time of your reset. I guess we all experienced that many times ; disk not validated anymore, and sometimes loss of data. Well, here is ShutDown. This new command will prompt you with a @{"ReqTools" link reqtools} requester before it resets the computer, securing your data, because all tasks can and will be finished. A real ShutDown as on UN*X systems. But there is more ... For those who have Static Memory (StatRAM device), ShutDown will call the 'killsd0' command imbedded in the STATRAM-package and enable you to perform a total ShutDown, including the recoverable RAM. There is an acknowledgement inside this procedure, so you cannot go wrong here. Each function of ShutDown is hereby protected ... :-) In other words, it might be a bit large (1.5 Kb), but its features are worth it, and I'm sure you'll find this command rather useful ... There's more to come : @{" To Do " link todo} No doubt these features will come soon, although I started coding this Software just to try out some ReqTools-possibilities. It worked just great, and therefor I decided to share the command with the rest of the world ; who knows who my use it ? :-) @endnode @node execution "Execution" Execution : ~~~~~~~~~~~ For v1.0 execution is rather easy : just double click the icon or type 'ShutDown' in a shell-window. From there onwards you'll be guided through the command thanks to the excellent @{" ReqTools " link reqtools} interface. As I already said, for the moment no tooltypes or command line options present, but this will soon be changed, if I have enough time to add the missing code (see @{" To Do " link todo}). @endnode @node install "Installation" Installation : ~~~~~~~~~~~~~~ This is the easy part ... Installing ShutDown isn't very tough ; you just need to copy it somewhere in your path, and that's all there is to be done. Simple, eh ? copy ShutDown C: Will copy the ShutDown program to your C: assign, which is always in the path, and will always give you access to the ShutDown command. @endnode @node about "About" Distribution : ~~~~~~~~~~~~~~ ShutDown is freely distributable software, but it's also Copyright (C) Tom De Voeght. You can freely copy/spread it as long as you don't make any profit doing it and that the original archive remains intact. The above is also known as FreeWare. IMPORTANT !!!! ~~~~~~~~~~~~~~ You will need a written permission from the author if you want to include ShutDown in ANY software package, either commercial or freely distributable packages. Disclaimer : ~~~~~~~~~~~~ The Author can't be held responsible for any damage this software may cause, directly or indirectly, on the system it is run. You're using it at your own risk. @endnode @node ack "Acknowledgements" Acknowledgements : ~~~~~~~~~~~~~~~~~~ The @{" author " link author} would like to thank the following people for their support : (alphabetical order) - Arun Kumar (thanks for learning me my first steps in C) - Nico Fran ois (Great @{"ReqTools" link reqtools} & other stuff) - Rafael D'Halleweyn (Tips & Suggestions. Thanx, Raf !) - The Amiga for being such a great pal ... I love it ... :-) ShutDown was developed on an antique A-500 with 1 Mb CHIP & 2 Mb FAST. AmigaOS 2.05 & 1.2 were both used for testing this program. @endnode @node author "Author" Author : ~~~~~~~~ ShutDown v1.0 is Copyright 1994 by Tom De Voeght. See @{" About " link about} for further details on distribution etc. The author can be reached for all bug-reports, suggestions, etc. : (flames will be politely discarded) Snail-Mail : Tom De Voeght Kempenlandstraat 23 2660 HOBOKEN BELGIUM - Europe E-Mail : tdv@suntew.ruca.ua.ac.be tvoeght@nyx.cs.du.edu If possible, send me a note if you decide to test this program ; I'd like to hear from you guys !!! @endnode @node history "History" History : ~~~~~~~~~ v0.5 : No big deal ; it was just an ordinary 'reset'-command. v0.7 : ReqTools-interface written. v0.9 : STAT-RAM support included. v1.0 : [FIRST PUBLIC RELEASE] - Should work fine now. @endnode @node todo "To Do" TO DO : ~~~~~~~ For the moment, it's a rather small and simple command. It's easy coding, and no fancy stuff imbedded. But of course I have some dreams : - Command line options. - Disable/Enable ReqTools Switch. - Direct rebooting (no acknowledgements) - Variable wait-periods before the actual ShutDown. - Anything else ? (tell me !) - Smaller code. (I still find 1.5 Kb rather large, but I'm a perfectionist) @endnode @node reqtools "ReqTools" ReqTools : ~~~~~~~~~~ This is the name of an excellent library, offering you the best looking requesters under all OS's. If you've never heared of it, check it out right NOW !!! -> ReqTools is Copyright (c) Nico Fran ois. <- Thanks, Nico, for such a great library, and of course thanks for making it available to the public !!! @endnode